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Certification and Warranty 



Certification Hewlett-Packard Company certifies that this product met its 

published specifications at the time of shipment from the factory. 
Hewlett-Packard further certifies that its calibration measure- 
ments are traceable to the United States National Bureau of Stan- 
dards, to the extent allowed by the Bureau's calibration facility, 
and to the calibration facilities of other International Standards 
Organization members. 



Wa T T 3 n t y This Hewlett-Packard system product is warranted against 

defects in materials and workmanship for a period of 90 days from 
date of installation. During the warranty period, HP will, at its op- 
tion, either repair or replace products which prove to be defective. 

Warranty service of this product will be performed at Buyer's 
facility at no charge within HP service travel areas. Outside HP 
service travel areas, warranty service will be performed at 
Buyer's facility only upon HFs prior agreement and Buyer shall 
pay HP's round trip travel expenses. In all other cases, products 
must be returned to a service facility designated by HP. 

For products returned to HP for warranty service, Buyer shall 
prepay shipping charges to HP and HP shall pay shipping charges 
to return the product to Buyer. However, Buyer shall pay all ship- 
ping charges, duties, and taxes for products returned to HP from 
another country. HP warrants that its software and firmware 



designated by HP for use with an instrument will execute its 
programming instructions when properly installed on that instru- 
ment. HP does not warrant that the operation of the instrument, 
or software, or firmware will be uninterrupted or error free. 



Limitation Of The foregoing warranty shall not apply to defects resulting from 
Wa r ra n ty improper or inadequate maintenance by Buyer, Buyer-supplied 
software or interfacing, unauthorized modification or misuse, 
operation outside of the environment specifications for the 
product, or improper site preparation or maintenance. 

No other warranty is expressed or implied. HP specifically 
disclaims the implied warranties of merchantability and fit- 
ness for a particular purpose. 



Exclusive Remedies The remedies provided herein are buyer's sole and ex- 
clusive remedies. HP shall not be liable for any direct, in- 
direct, special, incidental, or consequential damages, 
whether based on contract, tort, or any other legal theory. 

Product maintenance agreements and other customer assistance 
agreements are available for Hewlett-Packard products. 

For any assistance, contact your nearest Hewlett-Packard Sales 
and Service Office. 



Safety 



Summsry Of Safe The following general safety precautions must be observed during 

PrOCGd U res a ^ P nases of operation, service, and repair of this instrument. 

Failure to comply with these precautions or with specific warn- 
ings elsewhere in this manual violates safety standards of design, 
manufacture, and intended use of the instrument. Hewlett-Pack- 
ard Company assumes no liability for the customer's failure to 
comply with these requirements. 



Ground The To minimize shock hazard, the instrument chassis and cabinet 
I n St r U me n t must be connected to an electrical ground. The instrument is 

equipped with a three-conductor ac power cable. The power cable 
must either be plugged into an approved three-contact electrical 
outlet or used with a three-contact to two-contact adapter with the 
grounding wire (green) firmly connected to an electrical ground 
(safety ground) at the power outlet. The power jack and mating 
plug of the power cable meet International Electrotechnical Com- 
mission (IEC) safety standards. 



Do Not Operate In An 
Explosive 
Atmosphere 



Do not operate the instrument in the presence of flammable gases 
or fumes. Operation of any electrical instrument in such an en- 
vironment constitutes a definite safety hazard. 



Keep Away From Live 
Circuits 



Operating personnel must not remove instrument covers. Com- 
ponent replacement and internal adjustments must be made by 
qualified maintenance personnel. Do not replace components with 



the power cable connected. Under certain conditions, dangerous 
voltages may exist even with the power cable removed. To avoid 
injuries, always disconnect power and discharge circuits before 
touching them. 



Do Not Service Or 
Adjust Alone 



Do not attempt internal service or adjustment unless another per- 
son, capable of rendering first aid and resuscitation, is present. 



Do Not Substitute 
Parts Or Modify 
Instrument 



Because of the danger of introducing additional hazards, do not in- 
stall substitute parts or perform any unauthorized modification of 
the instrument. Return the instrument to a Hewlett-Packard 
Sales and Service Office for service and repair to ensure that 
safety features are maintained. 



Dangerous Procedure 
Warnings 



Warnings, such as the example below, precede potentially 
dangerous procedures throughout this manual. Instructions con- 
tained in the warnings must be followed. 



Warning 



9 



Dangerous voltages, capable of causing death, are present in 
this instrument. Use extreme caution when handling, testing, 
and adjusting. 



Safety Symbols 
Used In Manuals 



The following is a list of general definitions of safety symbols used 
on equipment or in manuals: 



Instruction manual symbol: the product is marked with this sym- 
bol when it is necessary for the user to refer to the instruction 
manual in order to protect against damage to the instrument. 

Indicates dangerous voltage (terminals fed from the interior by 
voltage exceeding 1000 volts must be marked with this symbol). 



Protective conductor terminal. For protection against electrical 
shock in case of a fault. Used with field wiring terminals to indi- 
cate the terminal which must be connected to ground before 
operating the equipment. 

Low-noise or noiseless, clean ground (earth) terminal. Used for a 
signal common, as well as providing protection against electrical 
shock in case of a fault. A terminal marked with this symbol must 
be connected to ground in the manner described in the installation 
(operating) manual before operating the equipment. 



Frame or chassis terminal. A connection to the frame (chassis) of 
the equipment which normally includes all exposed metal struc- 
tures. 

Alternating current (power line). 



Direct current (power line). 



Alternating or direct current (power line). 



The Note sign denotes important information. It calls your atten- 
tion to a procedure, practice, condition, or similar situation 
which is essential to highlight. 



The Caution sign denotes a hazard. It calls your attention to 
an operating procedure, practice, condition, or similar situa- 
tion, which, if not correctly performed or adhered to, could 
result in damage to or destruction of part or all of the 
product. 



The Warning sign denotes a hazard. It calls your attention to a 
procedure, practice, condition or the like, which, if not correctly 
performed, could result in injury or death to personnel. 



Using This Manual 



This manual provides detailed reference for the 68020 emulator 
commands. The detailed syntax descriptions apply to the 
emulator functions only. See the Analysis Reference Manual for 
32 -Bit Microprocessors for detailed descriptions of analysis com- 
mands. 



Organization 

Chapter 1 



Introducing 32-bit Emulation contains brief functional and 
physical descriptions of the emulation system and descriptions of 
basic emulation features. It also contains information on 
transparency and real-time emulation mode considerations. 



C h d p te r 2 Emulation Command Syntax describes the emulation com- 
mands in detail with command descriptions, command syntax 
diagrams, and examples 



Appendix A 



User Interface/HP-UX Cross Reference translates the HP 
64000- UX system softkeys into commands that can be entered 
from the HP-UX prompt. 



Appendix B Using Control Characters And Other Commands describe 

the use of control characters in the emulation session, and HP-UX 
and HP 64000-UX system commands available in an emulation 
session. 



Understandi n 9 This manual assumes that you are using the User-Friendly Inter- 

The Examples ** ace Sofl ware (HP 64808S) which is activated by executing the HP 

64000-UX pmon command. This means that the manual will 
show you how to enter HP 64000-UX system commands (edit, 
compile, assemble, link, msinit, msconfig, etc.) by telling you to 
press various softkeys. 

If you are not using "pmon", you will find the User Interface/HP- 
UX CROSS REFERENCE appendix of the this manual especially 
useful. The cross reference table will show you how the "pmon" 
softkeys translate into commands that can be entered from the 
HP-UX prompt. 

The examples provided throughout this manual use the following 
structure: 

PRESS edit module.S 

PRESS or press means you should enter a command by 

selecting the softkeys and/or typing in any 
file names or other variables which are 
not provided in the softkey selections. 

ed it softkeys will appear in bold type. Usually 

you will not be prompted to use the — 
ETC™ softkey to search for the ap- 
propriate softkey template. Three softkey 
templates are available at the HP 64000 
system monitor level. 

mod u I e . S this is the name of a file which you must 

type in. Softkeys are not provided for this 



type of selection since it is variable. 
However, a softkey prompt such as 
< FILE > will appear as a softkey selec- 
tion. 



For most commands, you must press the Return key before the 
command is actually executed. 



Notes 
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Introduction This chapter answers the following questions: 

• What is an emulation system? 

• What does an emulator enable you to do? 

• Does the emulator system run interactively with other HP 
64000-UX Microprocessor Development Environment 
modules 

• Does using an emulator have an effect on your program? 

• What is happening while your program is running? 

• What does the emulator do to your microprocessor system? 

• What are the steps in using the emulator? 
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What Is An 
Emulation System? 



Physical Description The 32-bit emulation system is a separate functional module 

within the HP 64000-UX Microprocessor Development Environ- 
ment. The emulation system consists of several hardware 
modules, the emulation software, and technical manuals. The fol- 
lowing hardware modules make up a typical 32-bit emulation sys- 
tem: 

• The emulation subsystem for your microprocessor 

• Integrated analysis board 

• Integrated analysis expansion board 

• Analysis interconnect board 

• Processor specific analysis bus generator board 

• Processor CPU cable 

The emulation system may be used interactively with other HP 
64000-UX emulation and analysis systems for more sophisticated 
measurements. 



Fu n Ct i O n a I The purpose of the emulator is to aid in the development of your 
Descri ption (target system) hardware and software design. You can use 

emulation during development of your system to ensure that the 
hardware and software being developed will work together. The 
emulator can be used in-circuit, alone, or with other products to 
debug your target system hardware and to integrate your 
software program modules with your target system hardware as 
you progress through the design phase. 
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Emulator Transparency 



To properly perform its function, the emulator must look like the 
microprocessor which will eventually control your system, as seen 
by your target system hardware. The function, signal quality, sig- 
nal timing, loading, drive capacity, and other factors at the plug- 
in connector should be indistinguishable from the same factors 
that would be present if the actual processor were being used. This 
characteristic is referred to as transparency. 

Functional Transparency. Functional transparency refers to 
the ability of the emulator to function in the same way as your 
processor would when the emulator is connected to your target 
system. Total functional transparency requires that the 
emulator execute your program, generate outputs, and respond 
to inputs exactly as the actual target processor would. At the 
same time, the emulator must be able to give you complete and 
immediate information about the clock-by-clock operation of 
your target system. HP 64000-UX 32-bit emulators are designed 
to perform their functions with minimum impact on functional 
transparency. 

Timing Transparency. Timing transparency refers to the 
timing relationships between signals at your target system plug- 
in. The timing relationships of signals at the emulation probe are 
designed to be equivalent to or better than the microprocessor it 
replaces in your system. 

Electrical Transparency. Electrical transparency refers to the 
electrical characteristics of the emulator target plug pins com- 
pared to the pins of the actual target processor. These charac- 
teristics include such things as rise and fall times, input loading, 
output drive capacity, and transmission line considerations. The 
electrical parameters at the emulation target plug pins are 
designed to be equivalent to or better than those of the 
microprocessor it replaces in your target system. 
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Independent Operation 

The emulation and analysis functions operate independent of the 
HP 64000-UX operating system. That is, once the emulation and 
analysis equipment has been configured and set into operation, 
the equipment can operate without interaction from the operating 
system. This is accomplished by using a multiprocessor system 
for controlling the operation of the emulation system and the HP 
64000-UX operating system. 

Emulation Probe 

The emulator allows you to replace the microprocessor in your tar- 
get system with a device which performs like the microprocessor, 
but which can be controlled by you from the development station. 
This is done through the emulation pod and microprocessor con- 
nector (probe) which is part of the cable extending from the emula- 
tion pod. The pod contains the emulation microprocessor that 
drives your target system. The microprocessor probe is plugged 
into your target system microprocessor socket. 
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What Tasks Does The tasks facilitated by an emulator are software debug, 
The Emulator DO? hardware debug, and hardware and software integration. These 

tasks are implemented by means of the following basic emulator 

features: 

• Program Loading and Execution. Your code developed on the 
HP 64000-UX using the editor, compilers, assembler, and 
linker, or valid code developed on other systems and trans- 
ferred to the HP 64000-UX host can be loaded into memory by 
means of the emulator and executed in the emulation environ- 
ment. 

• Run/Stop Controls. Programs may be run from address or 
symbolic locations. Emulation can be stopped by breaking into 
the emulation monitor or by resetting the microprocessor. 

• Memory Display/Modification. You can display locations or 
blocks of memory and modify any memory locations that can 
be changed. 

• Global and Local Symbols Display. You can display and find 
the addresses associated with your program's global and local 
symbols while in emulation. 

• Internal Resource Display/Modification. Allows you to display 
internal resources of the processor, such as registers, and to 
modify them, if desired. 

• Analysis (with optional integrated analyzer boards) . Allows 
you real time observation and display of activity on the emula- 
tion processor bus. 

• Program Stepping. Allows you to execute code instruction-by- 
instruction, gaining access to the internal machine states be- 
tween instructions. 

• Resource Mapping. Allows you to use emulation memory, tar- 
get memory, or both by denning the characteristics of the 
blocks of memory. 

• Memory Characterization. You can assign emulation memory 
as ROM or RAM. You can test "ROM" code without using 
ROM hardware. 
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• Breakpoint Generation. You can transfer program execution 
to an emulation monitor routine on the occurrence of a par- 
ticular machine state or range of states. 

• Clock Source Selection. Provides internal clock generation, 
which can be used in place of your target system clock. 



Does The 
Emulation System 
Run Interactively 
With Other HP 
64000-UX 
Modules? 



The HP 64000-UX Microprocessor Development Environment al- 
lows the use of emulation and analysis features in an interactive 
manner between an emulator and other modules. These modules 
can be other emulators or analyzers. Interaction allows the in- 
tegration of development work on designs, more elaborate and 
detailed analysis of a design, or both. The supported capabilities 
include: 

• simultaneous initiation of multiple measurements, 

• using the results of one measurement to control another, 

• and coordinating execution of a program with the initiation of 
a measurement. 



What Effect Does 
The Emulator 
Have On Your 
Program? 



The effect that the emulator has on your program depends upon 
the emulator operating mode you select for execution. The 
emulator never permanently alters your program, but it may af- 
fect the execution of your program. 
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Real-Time Mode Vs. Depending upon the emulator operation selected for execution, 
N O n rea l-Ti me M Ode ^ e emulator operates in one of two modes: real-time or nonreal- 

time. Real-time refers to the continuous execution of your target 
system program without interference from the host (except as in- 
structed by you, and then, only for specific operations). 

Interference occurs when a break to the emulation monitor is in- 
itiated either by you or automatically. The emulation monitor is a 
program which enables you to access the internal registers and 
memory of the microprocessor. 

Whenever the emulator is running under control of the emulation 
monitor, it is no longer executing your program in real time. The 
emulation monitor for your emulator is described in the Emulator 
Specifics manual for your emulator. 



Real-Time Mode Features that typically can be performed in real-time mode are 

Capabilities listedbeiow. 

run, some display, some modify, specify, 
execute, trace, load trace, stop trace 



Rea J-Ti me Mode Some features cannot be performed in real-time mode. These fea- 
Restrktions tures require breaking into the emulation monitor. Thesefea- 
tures are typically the following: 

• Target Memory Accesses-display, copy, load, modify, and 
store. 

• Register Accesses-display, copy, and modify. 

• Software Breakpoints-set and reset. 
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CAUTION m DAMAGE TO TARGET SYSTEM CIRCUITRY. When the 
emulator detects a guarded memory access or other illegal condi- 
tion, or when you request an access to memory which causes the 
emulator to break into the emulation monitor, the emulator 
stops executing you application code and enters the monitor. If 
you have circuitry that can be damaged because the emulator is 
not executing your application code, you should exercise special 
caution, ou should configure the emulator to be restricted to real- 
time mode, and you should not break into the emulation monitor. 



The above features can be accessed while the emulator is con- 
figured for real-time mode by causing a break into the emulation 
monitor. This happens when you press the break softkey and the 
Return key, when you attempt to access guarded memory, or 
when you execute a software break into the emulation monitor. 
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What Is 

Happening While 
Your Program Is 
Running? 



During Target During normal execution of your program, the emulation proces- 
Program Execution sorin the emulation pod generates address information for each 

cycle. One function of this hardware differentiates between your 
target system and emulation resources based on the address. If 
the pod identifies a target system resource with the current ad- 
dress, the datapath buffers between your target system and the 
emulator processor are enabled. If the address has been mapped to 
emulation resource space, the data path buffers between the 
emulation processor and the emulation bus resources are enabled. 

As your program runs, the integrated analysis circuitry observes 
the activity on the emulation analysis bus. Under your control, 
the analyzer can be instructed to store this program flow. The in- 
formation can be displayed later without interrupting the real- 
time flow of the program. 



During Emulation 
Monitor Program 
Control 



The main emulation functions of the emulator are achieved by 
seizing control of the emulation processor from your program and 
transferring control to the emulation monitor so that it can ex- 
tract the processor's internal information. The emulation monitor 
program provides the link between the emulation processor and 
the HP 64000-UX operating system. 

The emulation monitor is actually constructed of a number of 
separate routines. Some of these routines are executed automati- 
cally whenever the monitor program is entered. These routines 
extract the internal processor information that existed at the time 
of entry . This information can then be displayed on the station 
screen for examination by the operator. If, for instance, the 
monitor program was entered after the execution of a program in- 



Introducing 32-Bit Emulation 1-9 



struction, the internal machine state that existed at that time 
would be available. 



How Does The 
Emulator Affect 
Your 

Microprocessor 
System? 



The goal of the emulator is to look just like the microprocessor 
which will eventually control your system, as seen by your target 
system hardware. At the same time, it must be capable of giving 
you complete and immediate insight into the clock-by-clock opera- 
tion of the system. The function, signal quality, signal timing, 
loading, drive capacity, and other factors at the plug-in pins 
should be indistinguishable from the same factors that would be 
present if the actual processor were being used. This characteris- 
tic is referred to as transparency. The Emulator Specifics manual 
for your microprocessor discusses emulation functions that may 
affect your target system operation. 
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What Are The There are three steps to the emulation process (See figure 1-1): 

Steps To Using 
The Emulator? 

• Preparing the Software. 

• Preparing the Emulator. 

• Using the Emulator. 



Preparing The Preparing the software consists of creating and entering a 

S Of twa re program, assembling or compiling the program, and linking the 
assembled or compiled modules. This process is not covered in this 
manual. Refer to the appropriate Assembler/Linker or Compiler 
Manual for more information. 



Preparing The 
Emulator 



Preparing the emulator consists of properly initializing and defin- 
ing a measurement system to the HP 64000-UX operating 
software. This task is covered in the HP 64000-UX Measurement 
System Operating Manual. After the emulator is properly defined, 
you configure the emulator for your particular application. Con- 
figuration is discussed in the 68020 Emulator Operating Manual. 



Using The Emulator 



Using the emulator consists of loading your absolute code into the 
emulator (provided when programs are linked), and then using 
the features of the emulator to observe the program as it runs, dis- 
play the contents of the registers and/or memory and to debug 
your hardware and software. Using the emulator is covered in 
this manual and the 68020 Emulator Operating Manual. 



Introducing 32-Bit Emulation 1-11 



1. PREPARING THE SOFTWARE 2. PREPARING THE EMULATOR 














configuration 1 




file 1 



3. USING THE 
EMULATOR 



Figure 1-1 Steps to Using the Emulator 
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Emulation Command Syntax 



Overview Thischapter: 

• Describes the conventions used in the syntax diagrams in this 
manual. 

• Gives a summary of emulation commands. 

• Gives a detailed description of each emulator command. 
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Syntax 
Conventions 



The conventions used in the command syntax diagrams shown in 
this chapter are as follows: 



This symbol indicates a command keyword entered 



by pressing a softkey . The keyword is shown as it ap- 
pears in the command line and may not be the same 
as the softkey label. 

Rectangular boxes contain either prompts indicat- 
ing that parameters must be entered from the 
keyboard or references to additional syntax 
diagrams. Softkey prompts are enclosed by the " < " 
and " > " symbols and are shown exactly as they ap- 
pear on the softkey label. --EXPR-- and --SYMB- 
are also prompts, but allow you to access "expres- 
sion help" softkeys. You can return to the normal 
set of emulation softkeys by pressing -NORMAL-- 
. Syntax diagrams for --EXPR-- and --SYMB-- are 
included in this chapter. 

Reference to additional syntax diagrams may be 
shown in upper or lower case characters without 
delimiters. 

Circles are used to denote operators and delimiters 
used in expressions and command lines. 



Whenever keywords entered from softkeys appear in text or ex- 
amples, they are shown in bold type, i.e. copy. Command 
parameters entered from the keyboard are shown in standard 
type. 
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Command 
Summary 



A summary of emulation commands is given in table 2-1. Detailed 
descriptions of each command are given in the remainder of this 
chapter. 



Table 2-1. Emulation Command List 



at execution 


display registers 


modify memory 


break 


display trace* 


modify registers 


copy memory 


display sw breakpoints 


modify configuration 


copy registers 


display global symbols 


modify sw breakpoints 


copy sw breakpoi nts 


display local symbols 


modify analysis 


copytraci* 


d i spl ay trace - speci fi cati on * 


reset 


copy display 


expressions ~~ 


run 


copy global symbols 


halt 


step 


copy local symbols 


help 


store 


copy trace - speci f i cati on* 


load memory 


symbol 


copy help ~~ 


load trace specification 


trace* 


display memory 


load configuration 


wait 


* These commands a re descri bed i n the Analysis Reference Manual for 32-Bit Microprocessors. 
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Some command parameters shown in the following syntax 
diagrams may not be available when you are running emulation. 
What softkeys are available to you depends on how you configure 
the emulator for your emulation session. 

For example, if during memory mapping, you enter the com- 
mand: 

modify defined codes none 

all softkey references to function codes will be removed during 
your emulation session. Your answers to other emulation con- 
figuration questions also affect the softkey labels available to 
you. Only softkeys that are enabled for your emulation configura- 
tion are displayed. 
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execution 



Syntax 

(^qt_execution)- 





run 




<RETURN> 


) V » 


7 — > 



trace 



F U n Ct i O n At_execu1ion is used to prepare a run or trace command for ex- 
ecution. This command is used in conjunction with the execute 

command. If the processor is not reset, at execution run causes 

a break from your program, and initializes the monitor to the 
default address or to the specified address. An execute command 
then causes the run to occur. Once an execution has occurred, the 
run specification is removed and cannot be repeated without 
respecifying the run. 

at execution trace causes the trace hardware to be initialized 

with the given trace specification. An execute command then 
causes the trace to be executed. A trace specification is not 

removed and can be reexecuted without another at execution 

trace command, at execution trace and at execution run 

can be used with a single execute command initiating both the run 
and the trace, and starting any other analyzers that are connected 
to the intermodule bus (1MB). 

A trace command cancels an at execution trace command. A run 

or step command cancels a at execution run command. The 

at exec softkey label is displayed only with multiple module sys- 
tems. 



Default Value none 
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Example at execution run from START 

at_execution trace TRIGGER ON a = 1234h 

See Also : • Execute syntax (In this chapter) 

• Emulation configuration (Chapter 4 in the Emulator Proces - 
sor Specifics manual). 

• Operating In the Measurement System (in the HP 64000-UX 

User's Guide). 
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break 



Syntax 



breakj - 



<RETURN> 



F U n Ct i O n Break causes the processor to be diverted from execution of your 
program to the emulation monitor program. 

The break softkey is not displayed if the emulation monitor is not 
loaded. 



Default Value none 



Example break 
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copy 



Syntax 





memory 




\ 







registers 



sw_ breakpoints 



trace 



local_symbols 



display ^ ) s, 

global_symbols) ^ 



trace_specification 



help 



<FILE> 



v — >Q printerj- 




noappend 




T 



-*(Jy> \ HP_UX_CMD | Y*CD" 




noheader 
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F U n Cti O fl The copy command copies selected information to your system 
printer, to a listing file, or pipes it to an HP-UX filter. 



Def a U It Va lues Depending on what information is selected, defaults may be the 
options selected for the previous execution of the display com- 
mand. 



Parameters display 



<FILE> 



global_symbols 
help 



HP-UX CMD 



display enables you to copy the informa- 
tion currently displayed on the screen to 
the selected destination. 

< FILE > prompts you for the name of 
the listing file where the specified infor- 
mation is to be copied. 

global_symbols enables you to copy a list 
of all global symbols in memory to the 
selected destination. 

help enables you to copy the contents of 
the emulation help files to the selected 
destination. The keyword "help" is not 
available on the softkeys. It must be typed 
in from the keyboard. After help is typed 
in, the emulation help filenames are dis- 
played on the softkeys. 

HP-UX CMD represents an HP-UX filter 
or pipe you wish to route the output of the 
copy command to. HP-UX commands 
must be preceded by an exclamation point 
(!). An exclamation point following the 
HP-UX command causes command line 
execution to be continued after execution 
of the HP-UX command. Emulation is not 
affected when using an HP-UX command 
that is a shell intrinsic. 
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local sym- 
bols in 

memory 
noappend 

noheader 
printer 

registers 

sw breakpoints 

to 

trace 

trace specifica- 
tion 



local symbols in enables you to copy 

a list of local symbols in a specified source 
file to the selected destination. 

memory enables you to copy the contents 
of memory to the selected destination. 

noappend causes the copied information 
to overwrite any existing file with the 
same name specified by < FILE > . If 
noappend is not specified, the default 
operation is to append the copied informa- 
tion to the end of an (existing) file. 

noheader specifies that the information 
be copied without headings. 

printer specifies your system printer as 
the destination device for the copy com- 
mand. NOTE: Before you can specify 
printer as the destination device, you 
must first define PRINTER as a shell vari- 
able. 

$ PRINTER =lp 
$ export PRINTER 

registers enables you to copy the contents 
of the various register sets to the selected 
destination. 

software breakpoints enables you to 

copy the current software breakpoint 
table to the selected destination. 

to enables you to specify the destination of 
the copied information, to must be in- 
cluded in the command line. 

trace enables you to copy all of, or a por- 
tion of, the current trace listing to the 
selected destination. 

trace specification enables you to copy 
all of, or a portion of, the trace specifica- 
tion to the selected destination. 
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The exclamation point is the delimiter for 
HP-UX commands. @LABELTEXT = 
An exclamation point must precede all 
HP-UX commands. A trailing exclama- 
tion point to return to command line ex- 
ecution is optional. 

If an exclamation point is part of the HP- 
UX command, a backslash (\) must be 
used to escape the exclamation point (V.). 
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copy display 



Syntax 

display ^ - 



F U n Ct i O n The copy display command copies the information currently dis- 
played on the screen. 



Default Value none 



Examples copy display to printer 
copy display to trcfllel 
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copy 

global symbols 



Syntax 

> ^ global _ symbol s^ - 



F U n Ct i O n The copy global symbols command copies the global symbols 

defined for the current absolute file. Global symbols are those that 
are declared to be global (XDEF) in the source file. They include 
procedure names, variables, constants, and file names. When the 
copy global_symbols command is used, the listing will include 
the symbol name, logical address, segment containing the sym- 
bol, and the symbol's offset from the start of the segment. 



Default Value None 



Examples copy global symbols to printer 

copy global symbols to symbols noheader 
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copy help 



Syntax 

>T help (?)) >(HELP_FILE^) 



Fu n Cti O n The copy help command copies the contents of a specified help file. 

The help command is not displayed on the softkeys. It must be 
typed in from the keyboard. A question mark ( ? ) may be sub- 
stituted for the keyword help in the command string. 



Default Value none 



Examples copy help system_commands to printer 
copy ? trace to trc__cmd 



Parameters HELP_FILE HELP_FILE is the name of the help file 

you wish to copy. After you type help 
from the keyboard, the help file names 
are available on the softkeys. 
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loc sym 



Syntax 

^local_synnbols_iiV )- 





— SYMB — 




) — * 





F U n Ct i O n The copy local_symbols in command copies the local symbols 

in a specified source file or scope, their addresses, their relative 
segment, and offset. 



Default Value none 



Example copy local symbols in sample, s: to printer 



Pa ra mete rs -SYMB- -SYMB- represents the source file that 

contains the local symbols to be listed. See 
-SYMB- syntax diagram. 
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copy memory 



Syntax 



— ^memor)P) — >r 



v — ^mnemonic)- 



to_memory)- 



^ — » ( real } - 



I 



fcode ) -» [<FCODE> 



-» j <ADDR> 



thru ) -» f<ADDR> 



fcode ) -» f<F_CODE> 



s — »(absolutej- 



v — » { blocked y 



binary )- 



-»( short 



->(^ long 



byte 



ADDR [ ~> |<RETURN; 



pffset_by) - H --EXPR- 



F U n Ct i O n The copy memory command copies the contents of the specified 
memory location or series of locations. 

Memory can be copied to the system printer, to a listing file, to 
another area of memory , or piped to an HP-UX filter. When copy- 
ing to another area of memory, the destination memory locations 
must be in target RAM or emulation memory mapped as RAM or 
ROM. 



2-16 Emulation Command Syntax 



The memory contents can be listed either in mnemonic, binary, 
hexadecimal, or real number format. In addition, the memory ad- 
dresses can be listed offset by a value which allows the informa- 
tion to be easily compared to the program assembly listing. 



Default Values Initial values are the same as specified by the command "display 
memory 0 blocked words offset by 0". 

Defaults are to values specified in the previous display memory 
command. 



Examples copy memory fcode SUPER_PROG START thru 
START + 3fiH mnemonic to printer 

copy memory fcode SUPER DATA 0 thru 100H , fcode 

SUPER__PROG START thru START + 5 blocked long 
tomemlist 

copy memory fcode SUPER__PROG 1000 thru 13fih 
to memory fcode USER PROG2000h 



Parameters absolute 

<ADDR> 

binary 

blocked 
fcode 



absolute specifies that the memory list- 
ing be formatted in a single column. 

< ADDR > is a combination of numeric 
values, symbols, operators, and paren- 
theses specifying a memory address or of- 
fset value. See --EXPR- syntax diagram. 

binary specifies that the contents of 
memory locations be displayed as binary 
values. 

blocked specifies that the memory listing 
be formatted in multiple columns. 

fcode enables you to specify a function 
code along with the address expression as 
part of the memory access specification. 
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<F CODE> 



long 



mnemonic 



offset by- 



real 
short 

thru 

to memory 

words 



< F CODE > is a prompt for the func- 
tion code. The function code map be 
specified as a number or as a defined func- 
tion code mnemonic on the softkeys. 

long specifies that the memory values be 
copied as long word values. 

When used with the real parameter, long 
specifies that memory be copied in a 64- 
bit real number format. 

mnemonic causes the memory listing to 
be formatted in assembly language in- 
struction mnemonics with associated 
operands. When specifying mnemonic for- 
mat, you should specify a starting address 
that corresponds to the first word of an op- 
code to ensure that the listed mnemonics 
are correct. 

offset by enables you to specify an of- 
fset that is subtracted from each of the ac- 
tual absolute addresses before the addres- 
ses and the corresponding memory con- 
tents are listed. The value of the offset (- 
EXPR-) can be selected such that each 
module in a program appears to start at 
address 0000H. The memory contents list- 
ing will then appear similar to the as- 
sembly or compiler listing. 

real specifies that the memory values in 
the listing be formatted as real numbers. 

short is used with real to specify that 
memory values be listed as 32-bit real 
numbers. 

thru enables you to specify that a range of 
memory locations be copied. 

to memory enables you to copy a block 

of memory to another location in memory. 

words specifies that the memory listing 
be copied as word values. 
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, A comma (,) appearing immediately after 

memory in the command line will cause 
the current copy memory command to be 
appended to the preceding display 
memory command, resulting in the data 
specified in both commands being copied 
to the specified destination in the current 
command. The data will be formatted as 
specified in the current command. The 
comma is also used as a delimiter be- 
tween values when specifying multiple 
memory addresses. 

Function codes are an important part of the memory access 
specification, along with the address expression. The function 
code (if stated explicitly) precedes the associated address expres- 
sion, and may be specified as a number or one of the denned func- 
tion code mnemonics (e.g., SUPER_PROG, USER DATA). 

Memory configuration allows different modes for function codes: 
they may be enabled (full use of function codes), disabled (no use 
of function codes), or partially disabled (only PROGRAM/DATA 
spaces are recognized). If the function codes are disabled (even par- 
tially), the unused function code bits are masked off and ignored 
during the memory access. 
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copy registers 



Syntax 



registers 




F U n Ct i O n The copy registers command copies the current contents of the 
processor/coprocessor's various register sets. This process does 
not occur in real time. The emulation system must be configured 
for nonreal-time run mode if the registers are to be listed while 
the processor is running. 

The listed value of the CPU program counter can be offset from 
the actual value by a number which allows the register informa- 
tion to be easily compared to the assembled listing. 

When a custom coprocessor is specified, the coprocessor register 
set is appended to the CPU register 

set listing. 



Default Values Initially cpu registers with 0 offset; thereafter last copy registers 

command specification. 



Examples copy registers fpu to reglist 

copy registers cpu offset by lOfuh to printer 
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Parameters -EXPR- -EXPR- is a combination of numeric 

values, symbols, operators, and paren- 
theses specifying an offset value to be sub- 
tracted from the program counter. See - 
EXPR- syntax diagram. 

offset by offset by enables you to specify an of- 

fset that is subtracted from the actual cpu 
program counter address before the 
program counter value is copied. The 
value (-EXPR-) of the offset can be 
selected such that the program counter ad- 
dress will match the current instruction's 
address in the assembler or compiler list- 
ing. 

<REG SET> <REG SET> specifies the name of the 

register set to be displayed. The 
register set names may be selected from 
softkeys. All custom coprocessor 
names defined in your custom register 
specification file are displayed. The name 
cpu specifies that the 68020's internal 
cpu registers be displayed. The name fpu 
is reserved for the emulator's internal 
68881 floatingpoint processor, if used. 
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copy 

sw breakpoints 




Function The copy sw breakpoints command copies the currently defined 

software breakpoints and their status. If the emulation session is 
continued from a previous session, then the listing includes any 
previously defined breakpoints. The column marked status indi- 
cates whether the breakpoint is pending or inactivated. When in 
the pending state, a breakpoint causes the processor to enter the 
emulation monitor upon execution of that breakpoint. Break- 
points that have been defined as one shot are listed as inac- 
tivated after they have been executed. Entries that show an inac- 
tive status can be reactivated by executing the modify sw break- 
points set command. 



Default Value none 



Examples copy sw breakpoints to printer 

copy sw breakpoints offset by OfOOOh to breaklist 

noheader 
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Parameters <ADDR> 



offset by 



<ADDR> is a combination of numeric 
values, symbols, operators, and paren- 
theses specifying an offset from the listed 
software breakpoint address. See --EXPR-- 
syntax diagram. 

offset by allows you to offset the listed 

software breakpoint address value from 
the breakpoint's actual address. By sub- 
tracting the offset value from the 
breakpoint's actual address, the system 
can cause the listed address to match that 
given in the assembler or compiler listing. 
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copy trace 



F U n Ct i O n The copy trace command enables you to copy all of, or a portion of 
the current trace listing to the selected destination. 

See the Analysis Reference Manual for 32-Bit Microprocessors for 
a detailed description of the copy trace command 
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copy 

trace specification 



Fu n Cti O n The copy traee_specification command enables you to copy all of, 
or a portion of your trace specification to the selected destination. 

See the Analysis Reference Manual for 32 -Bit Microprocessors for 
a detailed description of the copy trace specification command. 
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display 



Syntax 



( ^display ~y 





memory 




<RETURN> 




r~~ 



registers 



trace 



sw_breakpoints 



local_symbols 



trace _ specification 



— ^( simulated _iq} ~ 



v — ^global _ symbols) - y 

A 



Function The display command displays selected information on your 

workstation screen. You can use the UP and DOWN cursor keys, 
The NEXT and PRE V keys, and in some cases, the LEFT and 
RIGHT cursor keys to view the displayed information. 



Def a U It Va I U es Depending on what information is selected, defaults may be the 
options selected for the previous execution of the display com- 
mand. 
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Pa ra mete rs giobal_symbois 



global symbols enables you to display 

a list of all global symbols in memory. 



local sym- 
bols in 

memory 
registers 
simulated_io 

sw breakpoints 

trace 

trace specifica- 
tion 



local symbols in enables you to dis- 
play a list of local symbols in a specified 
source file. 

memory enables you to display the con- 
tents of memory. 

registers enables you to display the con- 
tents of the microprocessor registers. 

simulated io enables you to display the 

data being written to the simio display 
buffer. 

sw breakpoints enables you to display 

the current software breakpoint table. 

trace enables you to display the current 
trace listing. 

trace specification allows you to dis- 
play your current trace specification, 
starting at optionally defined points. 
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display 

global symbols 



Syntax 



global_symbols 



> 



F U n Cti O n The display global symbols command displays the global sym- 
bols defined for the current absolute file. Global symbols are those 
that are declared to be global (XDEF) in the source file. They in- 
clude procedure names, variables, constants, and file names. 

When the display global symbols command is used, the listing 

will include the symbol name, logical address, segment contain- 
ing the symbol, and the symbol's offset from the start of the seg- 
ment. 



Default Value none 



Example display global symbols 
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display 

local symbols 



Syntax 





— SYMB — 




) — * 





Fu n Cti O n The display local_symbols in command displays the local sym- 
bols in a specified source file or scope, their addresses, their rela- 
tive segment, and offset. 



Default Value none 



Example display local symbols in towers.c: 



Parameters -SYMB- -SYMB- represents the source file that 

contains the local symbols to be listed. See 
-SYMB- syntax diagram. 
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display memory 



Syntax 



— memory} — *r 



* — H rnnemonic )- 



^— » ( reol ) - 



fcode }-»f<r_CODE> 



-* | <ADPR>~| - 



thru ) -» {~<ADDR> 



I 



v — » {absolute) - 
Vv — * ( blocked") - 



^ — » ( binary ) - 



I 



-»( short 



•*( long 



word J — s 



byte 



offset_by)-»| — EXPR — 



repetitively 



Function The display memory command displays the contents of the 

specified memory location or series of locations. The memory con- 
tents can be listed in mnemonic, binary, hexadecimal, or real 
number format. In addition, the memory addresses can be listed 
offset by a value which allows the information to be easily com- 
pared to the program listing. 



Default Values 



Initial values are the same as specified by the command "display 
memory 0 blocked word offset by 0". 
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Defaults are to values specified in previous display memory com- 
mand. 

Each of the memory access commands has a separate function 
code default to be used when a function code is valid, but not ex- 
plicitly specified. 



Examples display memory fcode SUPER_PROG START mnemonic 
offset__by lfDOh 

display memory fcode USER DATA 0 thru 100H , fcode 

USER PROG START thru START +5 blocked word 



Parameters absolute 



<ADDR> 



binary 

blocked 
fcode 

<F__CODE> 
long 



absolute specifies that the memory list- 
ing be formatted in a single column. 

<ADDR> is a combination of numeric 
values, symbols, operators, and paren- 
theses specifying a memory address or 
memory offset value. See --EXPR- syntax 
diagram. 

binary specifies that the contents of 
memory locations be displayed as binary 
values. 

blocked specifies that the memory listing 
be formatted in multiple columns. 

fcode enables you to specify a function 
code along with the address expression as 
part of the memory access specification. 

< F_CODE > is a prompt for the func- 
tion code. The function code may be 
specified as a number or as a defined func- 
tion code mnemonic on the softkeys. 

long specifies that the memory values be 
displayed as long word values. 



When used with the real parameter, long 
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mnemonic 



offset by 



real 

repetitively 

short 

thru 



words 



specifies that memory be displayed in a 
64-bit real number format. 

mnemonic causes the memory listing to 
be formatted in assembly language in- 
struction mnemonics with associated 
operands. When specifying mnemonic for- 
mat, you should specify a starting address 
that corresponds to the first word of an op- 
code to ensure that the listed mnemonics 
are correct. 

offset by enables you to specify an of- 
fset that is subtracted from each of the ac- 
tual absolute addresses before the addres- 
ses and the corresponding memory con- 
tents are listed. The value of the offset (- 
EXPR-) can be selected such that each 
module in a program appears to start at 
address 0000H. The memory contents list- 
ing will then appear similar to the as- 
sembly or compiler listing. 

real specifies that the memory values in 
the listing be formatted as real numbers. 

repetitively causes the system to repeti- 
tively update the memory listing dis- 
played on your screen. 

short is used with real to specify that 
memory values be listed as 32-bit real 
numbers. 

thru enables you to specify that a range of 
memory locations be displayed. Only 16 
lines of information can be displayed on 
the screen at one time. Use the UP and 
DOWN cursor keys, and the NEXT and 
PREV keys to view additional memory 
locations. 

words specifies that the memory listing 
be displayed as word values. 
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, A comma (,) appearing immediately after 

memory in the command line will cause 
the current "display memory" command 
to be appended to the preceding "display 
memory" command, resulting in the data 
specified in both commands being dis- 
played. The data will be formatted as 
specified in the current command. 

The comma is also used as a delimiter be- 
tween values when specifying multiple 
memory addresses. 

Function codes are an important part of the memory access 
specification, along with the address expression. The function 
code (if stated explicitly) precedes the associated address expres- 
sion, and may be specified as a number or one of the defined func- 
tion code mnemonics (e.g., SUPER_PROG, USER_DATA). 

Memory configuration allows different modes for function codes: 
they may be enabled (full use of function codes), disabled (no use of 
function codes), or partially disabled (only PROGRAM/DATA 
spaces are recognized). If the function codes are disabled (even par- 
tially), the unused function code bits are masked off and ignored 
during the memory access. 



Emulation Command Syntax 2-33 



display registers 



Syntax 



-H ^registers^ )- 




offset_by) -» [ — EXPR — 



F U n Ct i O n The display registers command displays the current contents of 
the processor/coprocessor's various register sets. If a step has just 
been executed, the mnemonic of the last instruction is also dis- 
played. This process does not occur in real time. The emulation 
system must be configured for nonreal-time run mode if the 
registers are to be displayed while the processor is running. 



The displayed value of the CPU program counter can be offset 
from the actual value by a number which allows the register infor- 
mation to be easily compared to the assembler listing. 

When a custom coprocessor is specified, the coprocessor register 
set is appended to the CPU register 

set listing. 



Def a U It Va I U es Offset is initially 0; thereafter previous value. 



Example display registers cpu 
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Pa ra mete rs -EXPR- -EXPR- is a combination of numeric 

values, symbols, operators, and paren- 
theses specifying an offset value to be sub- 
tracted from the program counter. See - 
EXPR- syntax diagram. 

offset by offset by enables you to specify an of- 

fset that is subtracted from the actual cpu 
program counter address before the 
program counter value is displayed. The 
value (-EXPR-) of the offset can be 
selected such that the program counter ad- 
dress will match the current instruction's 
address in the assembler or compiler list- 
ing. 

< REG SET > < REG SET > specifies the name of the 

register set to be displayed. The 
register set names may be selected from 
softkeys. All custom coprocessor 
names defined in your custom register 
specification file are displayed. The name 
cpu specifies that the 68020's internal 
cpu registers be displayed. The name fpu 
is reserved for the emulator's internal 
68881 floatingpoint processor, if used. 
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display 
simulated io 



Syntax 

simuloted_io 



F U n Ct i O n The display simulated io command displays the information 
being written to the simulated I/O display buffer on your screen. 
Refer to the HP 64000-UX Simulated I/O Reference Manualand 
chapter 8 of the 68020 Emulator Specifics Operating Manual for 
detailed information about using simulated I/O. 



Default Value none 



Example display simulated_io 
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display 

sw breakpoints 



Syntax 



->(j3w_ breakpoints *\ 



offset 



<ADDR> 



Fu n Cti 0 n The display sw breakpoints command displays the currently 
denned software breakpoints and their status. If the emulation 
session is continued from a previous session, then the listing in- 
cludes any previously defined breakpoints. The column marked 
status indicates whether the breakpoint is pending or inactivated. 
When in the pending state, a breakpoint causes the processor to 
enter the emulation monitor upon execution of that breakpoint. 
Breakpoints that have been defined as one shot are listed as in- 
activated after they have been executed. Entries that show an in- 
active status can be reactivated by executing the "modify 
sw breakpoints set" command. 



Default Value none 



Examples display sw breakpoints 

display sw breakpoints offset bylOOOH 
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Parameters <addr> 



offset by 



2-38 Emulation Command Syntax 



< ADDR> is a combination of numeric 
values, symbols, operators, and paren- 
theses specifying an offset value for the 
breakpoint address. See --EXPR- syntax 
diagram. 

offset by allows you to offset the listed 

software breakpoint address value from 
the breakpoint's actual address. By sub- 
tracting the offset value from the 
breakpoint's actual address, the system 
can cause the listed address to match that 
given in the assembler or compiler listing. 



display trace 



F U n Ct i O n The display trace command enables you to display all of, or a por- 
tion of the current trace listing. 

See the Analysis Reference Manual for 32-Bit Microprocessors for 
a detailed description of the display trace command. 
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display 

trace specification 



F U n Ct i O n The display trace_specification command enables you to display 
all of, or a portion of your trace specification. 

See the Analysis Reference Manual for 32-B it Microprocessors for 
a detailed description of the display trace specification com- 
mand. 
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execute 



Syntax 



Fu n Cti O n The execute command starts a trace measurement. The execute 
softkey label is replaced with the halt softkey label when a 
measurement is in progress. If emulation is participating in a sys- 
tem measurement through cross-triggered analysis or the emula- 
tion start function (at execution run or at execution trace), 

then the system measurement is initiated. Otherwise, the execute 
command is not available. 

A measurement can be executed repeatedly by issuing the ex- 
ecute repetitively command. This restarts the current measure- 
ment after each completion, until the user issues a halt command. 
The execute command starts all modules participating in a sys- 
tem measurement when issued from any one of the modules. If an 
emulator is started as part of a measurement, it continues run- 
ning and cannot be started again by subsequent executions unless 
an at execution run command is again issued. 

The execute softkey is displayed only when multiple modules are 
present in a system and some 1MB interaction is requested (cross- 
triggered analysis or emulation start function). 



Examples execute 

execute repetitively 
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See Also : • At execution command (in this chapter) 

• Emulation configuration (chapter 4 of the 68020 Emulation 
Operating Manual) 

• The "Operating in the Measurement System" section of the 
HP 64000 -UX User's Guide. 
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Syntax 



<NUMBER> 



5YMB 



start 



end )-J 



<0P> 



Fu fiction An expression is a combination of numeric values, symbols, 

operators, and parentheses specifying an address, data, status, or 
any of several other value types used in the emulation commands. 



Default Value none 



Examples 05fxh (not valid for all commands) 
DISP_BUF + 5 
SYMB_TBL + (OFFSET/ 2) 
START 

prog.s:linel5end 



Pa ra me te rs < NUMBER > < NUMBER > is a numeric value in bi- 

nary, octal, decimal, or hexadecimal base. 
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<0P> 



--SYMB-- 



start 



end 



0 
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< OP > is an algebraic or logical operand. 

< OP > may be (in order of precedence): 

mod (modulo) 

* (multiple) 

/ (divide) 

& (logical and) 

+ (plus) 

(minus) 

i (logical or) 

-SYMB-- is a symbolic reference to an ad- 
dress or address range, file, or other 
value. Symbols may be HP-UX paths, 
referenced line numbers in a file, file seg- 
ments (prog, data, common), or global and 
local symbols. 

start specifies that the starting address of 
the symbol range be used as the 
referenced location in the command. This 
parameter is useful with symbols that 
reference an address range rather than a 
single word value. 

end specifies that the last address in a 
symbol range be used as the referenced 
location in the command. This parameter 
is useful with symbols that reference an 
address range rather than a single word 
value. 

Parentheses may be used in expressions. 
For every opening parenthesis, a closing 
parenthesis must exist. 

Algebraic negation (minus) 

logical negation (NOT) 



Syntax 



( halt y 



<RETURN> 



F U n Ct i O n The halt command stops the measurement currently executing 
and turns off the repetitively option. When the halt command is 
executed, some or all of the systems involved may have completed 
their measurement. The halt softkey is displayed only during a 
trace, or during an execution (in the place of the execute softkey). 

The halt command affects measurements caused by both trace 
and execute commands. If emulation is entered with a measure- 
ment in progress, the halt command will stop that measurement 
even if emulation is not interacting in the measurement. 



Example halt 
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help 



Syntax 



^help (?)^) >^HELP_FILE^)- 



<RETURN> 



F U n Ct i O n The help command enables you to request information about sys- 
tem and emulation features during your emulation session. 
Typing "help" or "?" from the keyboard causes softkey labels to be 
displayed, listing the areas on which you may receive help. Press 
the softkey for the area you are interested in, and then press the 
return key. The system will list the information to the screen 
using the HP-UX more utility. 

The help command is not displayed on the softkeys. It must be 
typed in from the keyboard. A question mark ( ? ) may be sub- 
stituted for the keyword "help" in the command string. 



Default Value none 



Examples help system commands 

? trace 



Parameters help file 



HELP_FILE is the name of the help file 
you wish to display. After you type "help" 
from the keyboard, the help file names 
can be entered from the softkeys. 
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load 



Syntax 



( load ) — <r 



-»( memory )- 



<FILE> 



c 



v — ^ emulation ) ' 

^-* ( target ) ' 



• ( fcode y * \ <F_CODE> 




at y* <ADDR> 




no_update 



^ — * ^ trace_specification ) - 
^— ^(configuration) 




with trace data 




<FILE> 



<RETURN> 



F U n Ct i O n The load memory command transfers absolute code from the host 
system disc into target system RAM or emulation memory. The 
destination of the absolute code is determined by the memory con- 
figuration map which was set up during emulation configuration 
and the address specified during linking. 

You can force the absolute code to be loaded to a location in 
memory other than the address specified during linking by using 
the at < ADDR > parameter. When using at < ADDR >, the ab- 
solute code is loaded in memory beginning at the specified addess. 
For example, if you specify "at 2000h", you are effectively specify- 
ing an offset of + 2000h for your code. 
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N OTE 8fl This feature should not be used if your code uses absolute ad- 
dressing. Absolute addresses and symbol values in your program 
are not modified. This may result in run-time errors or unex- 
pected behavior. 



The load configuration command reloads an emulation configura- 
tion that you saved previously. 

The load trace_specification command reloads a trace specifica- 
tion that you saved previously. If you saved the trace specification 
with trace data, you can use the display command to access and 
display the previously stored trace data. You can execute the pre- 
viously stored trace specification using the trace again or execute 
commands. 



D ef a U 1 1 Va I U e For the load memory command, all memory is in the default func- 
tion code space. 



Examples load memory emulation sort 
load configuration config3 
load trace specification trace3 



Pa ra mete rs at at lets you load absolute code to a location 

in memory other than the address 
specified during linking. 

emulation emulation specifies that only the portions 

of the absolute file mapped as emulation 
memory will be loaded. 
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fcode 

<F_CODE> 

memory 
target 

configuration 



trace specifica- 
tion 



<FILE> 



noupdate 



with trace dat 

a 



fcode enables you to specify a function 
code along with the address expression as 
part of the memory access specification. 

<F CODE > is a prompt for the func- 
tion code. The function code map be 
specified as a number or as a defined func- 
tion code mnemonic on the softkeys. 

memory specifies that an absolute file is 
to be loaded into emulation or target 
memory. 

target specifies that only the portions of 
the absolute file mapped as target 
memory will be loaded. 

configuration specifies that a configura- 
tion file created by a modify configuration 
command be loaded. 

trace specification enables you to load 

a specified trace file previously generated 
using the store trace command. 

<FILE > is the pathname of the absolute 
file to be loaded from the system disk into 
target system RAM, emulation memory, 
or the trace memory (.TR files are as- 
sumed) containing a previously stored 
trace specification and trace listing. 

noupdate suppresses rebuilding of the 
symbol data base when loading an ab- 
solute file newer than its associated sym- 
bol data base. The default operation is to 
rebuild the symbol database. 

with__trace data specifies that the 

trace data be loaded along with the trace 
specification, if the trace data was stored. 
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modify 



Syntax 





memory 




<RETURN> 




r * 



^ — *| registers 



configuration)- 



sw_breakpoints 



analysis 



keyboard _to_simio 



J 



Function The modify command is used to review or edit the configuration, 
to modify the contents of memory (as integers or as real numbers), 
to modify the contents of the processor registers, and to modify the 
analysis trace command or portions of the analysis trace specifica- 
tion. You can also use the modify command to modify software 
breakpoints. 



Default Value none 



Pa ra mete rs configuration configuration enables you to review and 

modify (if necessary) the current emula- 
tion configuration. 
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memory 
registers 
sw breakpoints 

analysis 



trace com- 
mand 



memory enables you to modify the con- 
tents of selected memory locations. 

registers is used to modify the contents of 
one or more of the various register sets. 

sw breakpoints sets or clears software 

breakkpoints used with the emulator 
break function. 

analysis allows you to change any part of 
your analysis trace specification, or trace 
command. 



trace command brings the last trace 

command back to the command line for 
editing. 
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modify analysis 



Function The modify analysis command lets you change any part of your 
analysis trace specification or trace command. 

See the Analys is Reference Manual for 32 -B it Microprocessors for 
a detailed description of the modify analysis command. 
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modify 
configuration 



Syntax 




configuration 




F U n Ct i O n The modify configuration command enables you to review and 



edit the current emulation configuration. Each of the configura- 
tion questions is presented with the response previously entered. 
The prior response can be entered as displayed by pressing the 
return key, or modified as necessary and then entered by press- 
ing the return key. 



Default Value 



none 



Example 



modify configuration 
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modify 

keyboard to sim 

io 



Syntax 



>H keyboard_to_simio 




F U n Ct i O n The modify keyboard to simio command activates the 



keyboard to interact with your program through the HP 64000- 
UX simulated I/O software. While the keyboard is activated for 
simulated I/O, its normal interaction with emulation is disabled. 
The emulation soflkeys are blanked and the single softkey 
suspend is displayed on your screen. Pressing suspend and then 
the return key deactivates keyboard simulated I/O and returns 
the keyboard to normal emulation mode. Refer to the HP 64000- 
UX Simulated I/O Reference Manual and chapter 8 of the 68020 
Emulation Operating Manual for detailed information about 
simulated I/O. 



Default Value 



none 



Example 



modify keyboard__to_simio 
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modify memory 



Syntax 



memory ~) — byte j - 



word ~) ' ^-» ( fcode ) -> j<F_CODE> 



long y y 



<ADDR> 



"K^}~T [ <VALUE> 

thru ) -» | <ADDR> ] J ^ 



V — » ( real ~") - 



^< long )— ^ 



fcode }-*|<F_CODE>" 



^-»( short~^) ' 



<ADDR> 



/ K ^°)~7' 1 <-KLALff> | <r 



<REAL#> 



th 



ru )-*f~ <ADDR> 



Fu nction The modify memory command enables you to modify the contents 
of selected memory locations. The command can modify the con- 
tents of each memory location in a series to an individual value or 
the contents of all of the locations in a memory block to a single or 
repeated sequence of values. 

Function codes are an important part of the memory access 
specification, along with the address expression. The function 
code (if stated explicitly) precedes the associated address expres- 
sion, and may be specified as a number or one of the denned func- 
tion code mnemonics (e.g. SUPER_PROG, USER DATA). 
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If the specified address range is too small to contain the new 
data, the emulator will modify as many locations as is required 
to contain the new data, beginning with the starting address you 
specified. 

New data value lists will be repeated as needed to fill up the 
specified address ranges. Any left-over values will modify ad- 
dress locations after the last address in the specified address 
range. 



Default Values Each of the memory access commands has a separate function 
code default to be used when a function code is valid, but not ex- 
plicitly specified. 



Exa mples modify memory word fcode SUPER DATA OOAOh to 1234h 

modify memory word fcode USER DATA DATA1 to 0E3h , 

Olh, 

08h 

modify memory real long TEMP to 0. 5532E-8 



Parameters <ADDR> <ADDR> is a combination of numeric 

values, symbols, operators, and paren- 
theses specifying a memory address. See - 
EXPR- syntax diagram. 

byte byte specifies that the memory values be 

modified as byte values. 

fcode fcode enables you to specify a function 

code along with the address expression as 
part of the memory access specification. 
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< F__CODE > < F_CODE > is a prompt for the func- 

tion code, the function code map be 
specified as a number or as a defined func- 
tion code mnemonic on the softkeys. 

long long specifies that the memory values be 

modified as long word values. 

When used with the real parameter, long 
specifies that memory be modified as a 64- 
bit real number value. 

real real specifies that the memory values be 

modified as real number values. 

< REAL # > < REAL # > prompts you to enter a 

value in real number format. 

short short is used with real to specify that 

memory values be modified as 32-bit real 
number values. 

thru thru enables you to specify that a range of 

memory locations be modified. 

to to enables you to specify the values to 

which the selected memory locations will 
be changed. 

word word specifies that the memory locations 

be modified as word values. 

, commas (,) are used as delimiters between 

values when modifying multiple memory 
addresses. 



Description A series of memory locations can be modified by specifying the ad- 
dress of the first location in the series to be modified (-EXPR-) 
and the list of the values (-EXPR-) to which the contents of that 
location and the succeeding locations are to be changed. The first 
value listed replaces the contents of the specified memory loca- 
tion, the second value replaces the contents of the next location in 
the series, and so on until the list has been exhausted. If only one 
number or symbol is specified, only the single address indicated is 
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modified. When more than one value is listed, the value repre- 
sentations must be separated by commas. 

An entire block of memory can be modified such that the contents 
of each location in the block is changed to the single specified 
value, or to a single or repeated sequence. This type of memory 
modification is achieved by entering the limits of the memory 
block to be modified (-EXPR- thru -EXPR-) and the value or list 
of values (-EXPR--, ... , -EXPR-) to which the contents of all loca- 
tions in the block are to be changed. 

Function codes are an important part of the memory access 
specification, along with the address expression. The function 
code (if stated explicitly) precedes the associated address expres- 
sion, and may be specified as a number or one of the defined func- 
tion code mnemonics (e.g., SUPER_PROG, USER_DATA). 

Memory configuration allows different modes for function codes: 
they may be enabled (full use of function codes), disabled (no use of 
function codes), or partially disabled (only PROGRAM/DATA 
spaces are recognized). If the function codes are disabled (even par- 
tially), then the unused function code bits are masked off and ig- 
nored during the memory access. 
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modify registers 



Syntax 



— »(Vegistersy- 




<REG SET> 




*» <REG> 



<VALUE> 



F U n Ct i O n The modify register command is used to modify the contents of 
one or more registers in the processor/corpocessor's register set. 
The entry for < REG > determines which register is modified. 

Register modification cannot be performed during real time run- 
ning of the processor. A break must be performed to gain access to 
the registers. 



Default Value none 



Examples modify registers cpu DO to 9H 

modify registers cpu AO to 1001b , Al to 1023h 



Pa ra meters < REG > < REG > represents the name of the 

register to be modified. The possible 
entries for <REG> are displayed on 
softkey labels. 
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<REG SET> <REG SET> specifies the name of the 

register set to be displayed. The 
register set names may be selected from 
softkeys. All custom coprocessor 
names defined in your custom register 
specification file are displayed. The name 
cpu specifies that the 68020's internal 
cpu registers be displayed. The name fpu 
is reserved for the emulator's internal 
68881 floating point processor, if used. 

to to enables you to specify the values to 

which the selected registers will be 
changed. 

< VALUE > < VALUE > is a combination of numeric 

values, symbols, operators, and paren- 
theses specifying an register value. See- 
EXPR- syntax diagram. 
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modify 

sw breakpoints 



Syntax 



— »{^sw_breokpoints) — set ~) — <r 



^— > ^one_shot) — 
— >^ permanent^) y 



' s — * \ cleor y ~ 
disable V 
' — » (one_5hot ^ ~ 
^—►(permanentV 



-> ( entry ) » | <ENTRY> 

-*) <ADDR> 



f_code) -» j<F_CODE>[ 



F U n Ct i 0 n Software breakpoints enables the emulator to "break on execu- 
tion" of a specified address. Any valid address (number, label or 
expression) may be specified as a breakpoint. Valid addresses 
identify the first word of valid instructions. 

Operation of the program can be resumed after the breakpoint by 
either a run or step command. 



Default Values none 



Exa mp I es modify sw__breakpoints clear fcode USER_JPROG 1099h , 
1234h 

modify sw_breakpoints set fcode SUPER__PROG 
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one_shot 

L00P1END , LOOP2END 

modify sw breakpoints clear entry 1 

modify sw breakpoints disable entry 2 



Parameters <ADDR> 



all 



clear 
disable 

<F_CODE> 
one shot 



permanent 



< ADDR> is a combination of numeric 
values, symbols, operators, and paren- 
theses specifying a software breakpoint 
address. See -EXPR-- syntax diagram. 

If used with the set parameter, all causes 
all breakpoint entries to be reactivated 
(set to pending). If used with the clear 
parameter, all causes all entries to be 
cleared and the memory locations are res- 
tored to their original values, all also 
enables you to disable all entries or to 
change all entries to one-shot or per- 
manent mode. 

clear clears the specified breakpoint ad- 
dress < ADDR> and restores the original 
contents of the memory location. 

disable deactivates the selected break- 
point entry. 

< F CODE > is a prompt for the func- 
tion code. If used, the function code must 
be specified using one of the denned func- 
tion code mnemonics on the softkeys. 

one shot causes the breakpoint to be set 

for one execution. On execution, the 
breakpoint is deactivated and the original 
contents of the memory location is res- 
tored, one shot is also used to modify 

the mode of existing entries. 

permanent causes the breakpoint to be 
set until you clear or disable it. The break- 
point can be repeatedly executed, per- 
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manent is also used to modify the mode of 
existing entries. 

set enables you to set software break- 
points in your program. 

Commas (,) are used as delimiters be- 
tween specified breakpoint values. 
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reset 



Syntax 



c 



reset 



><RETURN> 



Fu n Cti O n The reset command suspends target system operation and rees- 



tablishes initial operatingparameters, such as reloading control 
registers. The reset signal is latched when the reset command is 
executed and is released by the run command. 

When the processor is released from reset by a run command, one 
of two operations will occur, depending on the answer to the 
reset to monitor question in configuration: 

• Reset to_monitor enabled: the processor will reset into the 

monitor, ignoring any user-defined reset vector. 

• Reset_to_monitor disabled: the processor will vector into 
the reset handler defined by the user reset vector. 



Default Value 



none 



Example 



reset 
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Syntax 



from J ^ 



-* | <AOOR>~| " 



<F_CODE>| ' 

^— » ( transfer_oddress )- 



- H<R£TURN>] 



until ) — f <F_CODE>~| -» j <ADDR~ 



Function If the processor is in a reset state, run will cause the reset to be 

released, and if a "from" address is specified the processor will be 
directed to that address. If the processor is running in the monitor, 
the run command causes the processor to exit into your program. 
The program can either be run from a specified address (-EXPR- 
), from the address currently stored in the processor's program 
counter, or from a label specified in the program. 

ill run until the until address is encountered and then break to the 
monitor. The until " < ADDR > " specification also causes a 
software breakpoint to be set up at the address requested. 

cifications are not allowed. 



Def a U 1 1 Va I U e If the address (-EXPR-) option is omitted, the emulator will 

begin program execution at the current address specified by the 
processor's program counter. 



Examples run 

run from 810H 
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run from USER STATE START until LOOP_l 

run until SUPERVISOR STATE LOOP 1 



Parameters <addr> 



<F CODE> 



from 

transfer_ad- 
dress 



until 



< ADDR> is a combination of numeric 
values, symbols, operators, and paren- 
theses specifying a memory address. See - 
EXPR-- syntax diagram. 

< F_CODE > is a prompt for the func- 
tion code. If used, the function code must 
be specified using one of the defined func- 
tion code mnemonics on the softkeys. 

from is used to specify the address from 
which program execution is to begin. 

transfer address is the starting ad- 
dress of the program you loaded into 
emulation or target memory. The trans- 
fer address is defined in the linker map. 

until is used in defining a software break- 
point on which to break execution of your 
program. 
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step 



Syntax 



c y 




<#STEPS>. 




■ <RETURN> 



from y 





<ADDR> 






C ' 





<F CODE> 



^ — »{^transfer_address)- 



F U n Ct i O n The step command allows program instructions to be sequentially 
analyzed by causing the emulation processor to execute a 
specified number of instructions. The contents of the processor 
registers, the contents of trace memory, and the contents of emula- 
tion or target memory can be displayed after each step command 
has been completed. 



Default Values Ifno value is entered for < NUMBER > of times, only one instruc- 
tion is executed each time the return key is pressed. Multiple in- 
structions can also be executed by holding down the return key. 

If the from address (-EXPR- or transfer__address) option is 
omitted, stepping begins at the next address. 



Exa mples step Return 

step from fcode SUPERVISOR_STATE 810h 
step 20 from fcode USER STATE OAOh 
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Parameters <addr> 

<F_CODE> 
from 

< NUMBER > 



transfer ad- 
dress 



< ADDR > is a combination of numeric 
values, symbols, operators, and paren- 
theses specifying a memory address. See - 
EXPR-- syntax diagram. 

< F__CODE > is a prompt for the func- 
tion code. If used, the function code must 
be specified using one of the defined func- 
tion code mnemonics on the softkeys. 

from is used to specify the address from 
which program stepping is to begin. 

< NUMBER > determines how many in- 
structions will be executed by the step 
command. The number of instructions to 
be executed can be entered in binary (B), 
decimal (D), octal (0, or Q), or 
hexadecimal (H) notation. 

transfer address is the starting ad- 
dress of the program you loaded into 
emulation or target memory. The trans- 
fer address is defined in the linker map. 
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store 



Syntax 



( store — memory")- 



fcode )-»| <F_CODE> 



-*| <ADDR> 



) 






-> 




^-*C" thru y*\ <ADDR> 



»(_ troce_specificotion^)- 



with trace data 



-» ( to_file~) » j <FILE> ~[ * |<RETURN>] 



Fu n Cti O n The store command is used to store the contents of specific 

memory locations into an absolute file (.X file), or to store the 
trace specification, with or without trace data, into a trace file (.TR 
file). 



Default Value None 



Examples store memory fcode USER_PROG 800h thru 20ffhto_file 

temp2 

store trace specification to file trclst 



Pa ra mete rs --EXPR- -EXPR- is a combination of numeric 

values, symbols, operators, and paren- 
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fcode 

<F_CODE> 

<FILE> 

memory 

thru 
to file 



trace specifica- 
tion 



with trace_dat 

a 



theses specifying a memory address. See - 
EXPR-- syntax diagram. 

fcode enables you to specify a function 
code along with the address expression as 
part of the memory access specification. 

<F CODE > is a prompt for the func- 
tion code. The function code map be 
specified as a number or as a defined func- 
tion code mnemonic on the softkeys. 

< FILE > is a prompt for the identifier for 
the absolute file or trace file in which data 
is to be stored. 

memory specifies that the selected 
memory locations be stored in the 
specified file. 

thru enables you to specify that memory 
ranges be stored. 

to file must be used in the store memory 

command to separate the memory loca- 
tion specifications from the file identifier 
«FILE». 

trace specification specifies that the 

current trace specification data be stored 
in the specified file. 

with_trace data specifies that the 

trace data be stored along with the trace 
specification. 

Commas (,) are used to separate memory 
expressions in the command line. 



Descri pti On < FILE > determines the name under which the absolute or trace 
file is to be stored. The store command creates a new file having 
the specified name as long as there is no absolute file presently on 
the disc with that name. In the case where a file represented by 
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the < FILE > variable already exists, the system asks whether 
the old file is to be deleted. If the response is yes, the new file 
replaces the old one. If the response is no, then the store command 
is canceled and no data is stored. The transfer address of the ab- 
solute file is set to zero. 
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--SYMB-- 



Syntax 



-SYMB-- 



<FILE> 



r — line ) 
^— »{^segment J- 





<LINE> 




) * 





<5C0PE> <r-^ 



<SEGMNT> 



<SYMBOL> 



NOTE ^| If no default file has been defined by executing the display 

local symbols in or load memory commands, a source file 

name ( < FILE > ) must be specified with the first local symbol in 
a command line. The specified file is then used as the default file 
for subsequent symbols in that command line until a new source 
file name is specified. When the command is executed, the 
default file name returns to the file name specified in the last dis- 
play local symbols in command (if one has been executed) 

or the last load memory command. 



F U n Ct i O n --SYMB-- is a symbolic reference to an address or address range, 
file, or other value. Symbols may be HP-UX paths, referenced line 
numbers in a file, file segments (prog, data, common), or global 
and local symbols. 
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Def a U It Va lu e Lastfile specified in a "display local symbols in" command. 

If display local symbols in has not been executed in the cur- 
rent emulation session, default is the last file specified in a load 
memory command, or none if a file has not been loaded. 



Examples module.S:line5 

keybd.S : scankeys.LOOPl 
segment "DATAV 



Parameters <file> 

line 

<LINE> 
< SCOPE > 

segment 

<SEGMNT> 
<SYMBOL> 



< FILE > is an HP-UX path specifying a 
source file. If no file is specified, the 
default file is assumed, if one exists. 

line specifies that the following value is a 
line number. 

< LINE > prompts you to enter a line 
number. 

< SCOPE > prompts you to enter the 
identifier of the portion of the program 
where the specified symbol is defined or 
active. 

segment indicates that the following 
string specifies a program segment (prog, 
data, common) in the source file. 

< SEGMNT > prompts you to enter a 
program segment. 

< SYMBOL > prompts you to enter a 
symbol name. 

A colon (:) separates the HP-UX path 
specifier from the line, segment or symbol 
specifier. If no path specifier precedes :, 
then the default file is assumed for line or 
segment, and < SYMBOL > is assumed 
to be a global symbol. 
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trace 



F U n Ct i O n The trace command allows you to trace program execution using 
theHP 64404A and 64405A Integrated Analyzers. 

See the Analysis Reference Manual for 32 -B it Microprocessors for 
a detailed description of the display trace command. 
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Syntax 



> 



T 



T 




T 



<TIMER> 



measurement complete 




T 



<TIMER> 



stepping_complete 

(E>— 




F U n Ct i O n The wait command is a delay command. Delay commands are en- 
hancements that allow flexible use of command files (although 
delays are also available outside of command files). Command 
delays give the emulation system and target processor time to 
reach some condition or state before bringing in the next com- 
mand. The delay commands may be included in command files. 

The wait command is not displayed on the softkeys. You must 
type the command from the keyboard. After you type "wait", the 
wait command parameters are displayed on the softkeys. 



Default Value Waiting for Ctrl C 
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NOTE & if "set intr V has not been executed on your system, replace Ctrl 
fc c with the backspace key in the following examples and 
parameter definitions. 



Examples 



wait 
wait 6 

wait measure- 
ment complete 



wait measure- 
ment com- 
plete or 20 



emulator waits for Ctrl c before accepting 
the next command. 

emulator waits for Ctrl c or 6 seconds 
before accepting the next command. 

emulator waits for Ctrl c or for a pending 
measurement to complete. If no measure- 
ment is in progress, wait will be satisfied 
immediately. 



emulator waits for Ctrl c, for a pending 
measurement to complete, or 20 seconds 
(whichever occurs first) before accepting 
the next command. 



Parameters measure- 
ment complete 



stepping com- 
plete 



measurement complete causes the 

system to wait for a measurement in 
progress to complete before the next com- 
mand is executed. 

stepping complete causes the system 

to wait for the currently executing step- 
ping command to complete before execut- 
ing another command. 
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< TIME > < TIME > is the number of seconds you 

insert for your delay. 
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Notes 
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A 

User Interface Software/HP-UX Cross Reference 



Table A-1. User Interface/HP-UX Cross Reference 



USER INTERFACE 


HP-UX 


COMMAND OPTION 


COMMAND OPTION 


edit 


Defined by the variable " EDITOR" 


recover 


-r 


Readonly 


-R 


compile 


comp 


list 


-I 


no list 


-n 


expand 


-e 


no code 


-t 


xreF 


-x 


output 


-o 


verbose 


-V 


list to 


> 


print 


| SPRINTER 
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Table A-1. User Interface/HP-UX Cross Reference (Cont'd) 



USER INTERFACE 




HP-UX 


COMMAND 


OPTION 


COMMAND 


OPTION 


assemble 


asm 




list 




-I 




no list 




-n 




expand 




-e 




no code 




-t 




xreT" 




-x 




output 




-o 




verbose 




-V 




list to 




> 




print 




| SPRINTER 


link 


Ink 




list to 




-I 




print 




| SPRINTER 




xref 




-x 




output 




-o 




no map 




-n 




no ovlp 




-c 


prom prg 


prom prg 


list dir 


Is 




Filetype 




-F 




time mod 




-t 




use "time 




-u 




reverse 




-r 




all 




-a 




Recurse 




-R 




anychar 




? 




anystrng 




* 




list to 




> 




print 




| SPRINTER 




long 




-I 
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Table A-1. User Interface/HP-UX Cross Reference (Cont'd) 



USER INTERFACE 
COMMAND OPTION 


HP-UX 

COMMAND OPTION 


remove 


rm 


anychar 
anystrng 
force 
recurse 
i nteract 


* 

-f 
-r 
-i 


move 


mv 


anychar 
anystrng 
force 


? 
* 

-f 


copy 


cp 


anychar 
anystrng 


? 
* 


cat 


cat 


anychar 
anystrng 


? 
* 


makedir 


mkdir 


removdir 


rmdir 


chng dir 


cd 


date&time 


date 


opt test 


opt 


manual 


man 


keyword 
list to 
print 


-k 
> 

| SPRINTER 
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Table A-1. User Interface/HP-UX Cross Reference (Cont'd) 



USER INTERFACE 


HP-UX 




COMMAND 


OPTION 


COMMAND 


OPTION 


log 


log commands 




to 




to 




off 




off 


shell 


i 


tarchive 


tar 




add 




r 




update 




u 




extract 




X 




create 




c 




table 




t 




anychar 








anystrng 




* 




no dir 




0 




file/dev 




f < device > 




verbose 




V 




prsvmode 




P 




marknow 




m 


I if copy 


lifcp 




binary 




-b 




anychar 








anystrng 




* 




translat 




-t 




raw 




-r 


lifremv 


lifrm 


lifrenam 


1 if rename 







A-4 User Interface/HP-UX Cross Reference 



Table A-1. User Interface/HP-UX Cross Reference (Cont'd) 



1 ICCD IMTCDCA^C 

COMMAND OPTION 


LID 1 IV 

HP-UX 

COMMAND OPTION 


liflist 


lifls 


long 
list to 
print 


-1 
> 

IMPRINTER 


lifinit 


lifinit 


vol name 


-n 


msinit 


msinit 


search 


-s 


msconfig 


msconfig 


msstat 


msstat 


< system name> 

i.e. emul682K 


< system name> 
i.e. emul682K 
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Notes 
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B 

Using Control Characters And Other Commands 



Using Control The following control characters can be used in HP 64000-UX: 

Characters 

• CTRL b recalls commands starting from the first command 
you entered. You can continue pressing these keys to observe 
commands previously executed. 

• CTRL c is an interrupt, and stops processing of the current 
command. In Option Test, this has no effect (this is different 
from most HP 64000-UX interfaces, and is set this way so that 
the HP 64000-UX hardware is never left in an unknown 
state).** 

• CTRL d stops all tests and exits HP 64000-UX features.** 

• CTRL e clears the command line from the cursor location to 
the end of the line. 

• CTRL f rolls the diagram left while in emulation. 

• CTRL g rolls the diagram right while in emulation. 

• CTRL 1 refreshes (redraws) the display. 

• CTRL q resumes scrolling of information on the screen (that 
was stopped with CTRL s). 

• CTRL r recalls commands from the previous command you 
entered (scrolling through the commands toward the first com- 
mand). You can continue pressing these keys to observe com- 
mands previously executed. 
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CTRL s temporarily stops scrolling of information on the 
screen (resume with CTRL q). 

CTRL u clears the command line.** 

CTRL \ (backslash) stops all tests and exits HP 64000-UX fea- 
tures.** 

Tab moves the cursor to the next word on the command line. 

Shift Tab moves the cursor back one word on the command 
line (this is for HP terminals only). 

** Depends on actual stty settings. 



Other Control Other control characters and commands you can use are listed 

Characters And helow - 
Commands You 
Can Use 

• # is used to include comments in files. All characters after the 
"#" are ignored when the file is executed. 

• help or ? displays the possible help files. 

• ! forks an HP-UX shell (using the $SHELL environment vari- 
able). 

• cd changes directory for the present HP-UX shell. 

• < FILE > pi p2 p3 executes a command file and passes three 
parameters. 

• log commands to < FILE > puts commands you execute 

into a file that you specify. 

• wait pauses a command file until you press CTRL c 
(SIGnal_INTerrupt). 
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• wait measurement complete pauses a command file until 

the measurement is complete, or until CTRL c (SIG INT). 

• wait < TIME > pauses a command file until < TIME > (in 
number of seconds) has passed, or until CTRL c is pressed. 
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Notes 
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Index 



A 



analysis, 1-5 

at execution syntax, 2-5 



B 



break command syntax, 2-7 
break syntax, 2-7 
breakpoint generation, 1-6 



c 



clock source selection, 1-6 



command summary, emulation, 2-3 

control characters, using, B-l 

copy display command syntax, 2-12 

copy global_symbols command syntax, 2-13 

copy help command syntax, 2-14 

copy local symbols in command syntax, 2-15 

copy memory command syntax, 2-16 
copy registers command syntax, 2-20 

copy sw breakpoints command syntax, 2-22 

copy command syntax, 2-8 
copy trace command, 2-24 
copy trace_specification command, 2-25 

D damage to target system circuitry, 1-8 
display command syntax, 2-26 
display global_symbols command syntax, 2-28 

display local symbols in command syntax, 2-29 

display memory command syntax, 2-30 
display registers command syntax, 2-34 
display simulated_io command syntax, 2-36 

display sw breakpoints command syntax, 2-37 

display trace command, 2-39 

display trace specification command, 2-40 

E electrical transparency, 1-3 
emulation probe, 1-4 
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emulation system, physical description, 1-2 
emulator effects on user program, 1-6 
execute command syntax, 2-41 
expression syntax, 2-43 

functional description of emulator, 1-2 
functional transparency, 1-3 

halt command syntax, 2-45 

hardware modules, emulation system, 1-2 

help command syntax, 2-46 

how the emulator affects the target system, 1-10 

interactive measurements, 1-6 

interactive operation with other modules, 1-6 

internal processor resources display/modify, 1-5 

load command syntax, 2-47 

memory characterization, 1-5 

memory display/modification, 1-5 

microprocessor replacement probe, 1-4 

modify analysis command, 2-52 

modify command syntax, 2-50 

modify configuration command syntax, 2-53 

modify keyboard_to_simio command syntax, 2-54 

modify memory command syntax, 2-55 

modify registers command syntax, 2-59 

modify sw breakpoints command syntax, 2-61 

operational independence from host system, 1-4 

physical description, emulation system, 1-2 
preparing the emulator, 1-11 
preparing the software, 1-11 
program loading, 1-5 
program stepping, 1-5 

real-time mode capabilities, 1-7 
real-time mode restrictions, 1-7 
real-time vs. non-real-time mode, 1-7 



reset command syntax, 2-64 
resource mapping, 1-5 
run command syntax, 2-65 
run/stop controls, 1-5 

step command syntax, 2-67 

store command syntax, 2-69 

symbol display, global and local, 1-5 

symbol syntax, 2-72 

syntax conventions, 2-2 

systen commands available in emulation, B-2 

timing transparency, 1-3 
trace command, 2-74 
transparency, electrical, 1-3 
transparency, functional, 1-3 
transparency, timing, 1-3 
transparency to target system, 1-3 

user interface/HP-UX cross reference, A-l 

using the emulator, 1-11 

using the emulator, steps to, 1-11 

wait command syntax, 2-75 

what happens during program execution, 1-9 

what is an emulation system, 1-2 



Notes 
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